Reference Link is an INIT that makes THINK Reference 2.0 easier to use if you have System 7. With Reference Link installed, you can do a control-option-double-click on a word in a text editor or word processor, whereupon the word will be looked up in THINK Reference 2.0. Alternately, you can first select a word or phrase, and then type control-option-r, and the selected text will be looked up in THINK Reference. If THINK Reference is not already running, it will be launched. If you type control-option-r while THINK Reference is in front, you go back to the editor. If you type control-option-t while a word is selected, the word will be replaced by its template.
In the previous paragraph, you should take the word “editor” in its broadest sense: Any application in which one can select some text and copy it to the clipboard, be it THINK C or CompuServe Navigator.
How it Works
Reference Link uses a JGNEFilter patch to monitor events, and uses a head patch on WaitNextEvent in Finder to get some background time when looking up templates. The patch code uses about 4K of System heap.
Customizing Reference Link
As it is distributed, Reference Link watches for control-option double-click or control-option-r to look something up, and control-option-r to send you back to the editor. These can be changed with the aid of ResEdit. Open Reference Link and open the 'Keys' resource. The first item therein is a modifier mask for double-clicks. The text beside the box gives numbers for the various modifier keys, which you add together to represent combinations. For example control is 4096 and option is 2048, so control-option is 4096+2048 = 6144. Next comes the modifiers for the keystrokes, then the key codes for the keystrokes. Note that a key code is not the same as a character code. To find a key code, look up “extended keyboard” in THINK Reference 2.0. I used the same keystroke for both look-up and jump-back, since only one makes sense in a given context, but you can make them different if you wish.
When Reference Link sees a mouse click with the specified modifiers, the event is passed on to the editing application as an unmodified click. Therefore you should not choose a modifier combination likely to have an existing meaning in some applications, such as plain command, option, or shift.
If you want to deactivate Reference Link in certain applications, you can insert their application signatures (AKA creator codes) in the 'Excl' resource.
If you use Super Boomerang, I suggest that you configure it to exclude THINK Reference from the “Re-Launch” feature. This may prevent a problem when Reference Link launches THINK Reference.
I am told that RadiusWare uses control-option-click for a pop-up menu, so users of RadiusWare should choose a different modifier combination for Reference Link.
Known Limitations
The template function is more iffy than the lookup function. It goes through some contortions to send AppleEvents when the foreground application is not Apple Event aware (e.g., THINK C 5.0), and may not work at all in applications that use a private scrap (such as Navigator).
Neither keystroke will work in desk accessories, but the modified double-click seems to work.
About the Icon
The icon was designed by Tom Poston of ImMedia. Thanks to Burt Johnson for paying for that service.
By the way, if you used the first version, 1.0b1, you will need to rebuild your desktop if you want to see the new icon.
Distribution
Reference Link is copyrighted freeware. Of course if you *want* to send me some money for it, you can.
Reference Link may not be sold or offered for sale, or included with another software product offered for sale, except with the express written permission of the author. The author’s failure to give permission promptly should not be taken as consent. Companies that distribute public domain/freeware/shareware software for profit are expressly prohibited from distributing Reference Link. This restriction does not apply to bulletin boards, commercial on-line services such as America Online, CompuServe and GEnie, and nonprofit Macintosh user groups which hold regularly scheduled public meetings.
